package com.york.jobmew.subject.infra.basic.service;

import com.york.jobmew.subject.infra.basic.entity.SubjectInfo;

import java.util.List;

/**
 * 题目信息表(SubjectInfo)表服务接口
 * 提供对题目信息的增删改查及分页查询等功能。
 */
public interface SubjectInfoService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键，题目的唯一标识符
     * @return 对应的题目信息实例对象
     */
    SubjectInfo queryById(Long id);

    /**
     * 新增数据
     *
     * @param subjectInfo 题目信息实例对象
     * @return 插入后的题目信息实例对象（包含生成的主键等信息）
     */
    SubjectInfo insert(SubjectInfo subjectInfo);

    /**
     * 修改数据
     *
     * @param subjectInfo 题目信息实例对象
     * @return 更新后的题目信息实例对象
     */
    SubjectInfo update(SubjectInfo subjectInfo);

    /**
     * 通过主键删除数据
     *
     * @param id 主键，题目的唯一标识符
     * @return 是否删除成功
     */
    boolean deleteById(Long id);

    /**
     * 根据条件计数有多少题目，用于条件筛选记录分页总数
     *
     * @param subjectInfo 题目信息实例对象，包含筛选条件
     * @param categoryId  分类ID，用于筛选题目所属分类
     * @param labelId     标签ID，用于筛选题目所属标签
     * @return 符合条件的题目总数
     */
    int countByCondition(SubjectInfo subjectInfo, Long categoryId, Long labelId);

    /**
     * 分页查询题目信息
     *
     * @param subjectInfo 题目信息实例对象，包含筛选条件
     * @param categoryId  分类ID，用于筛选题目所属分类
     * @param labelId     标签ID，用于筛选题目所属标签
     * @param start       分页起始位置
     * @param pageSize    每页大小
     * @return 符合条件的题目信息列表
     */
    List<SubjectInfo> queryPage(SubjectInfo subjectInfo, Long categoryId, Long labelId, int start, Integer pageSize);

    /**
     * 获取题目贡献统计信息
     *
     * @return 题目贡献统计信息列表
     */
    List<SubjectInfo> getContributeCount();

    /**
     * 查询题目ID游标,上一道和下一道要用
     *
     * @param subjectId  当前题目ID，用于定位游标
     * @param categoryId 分类ID，用于筛选题目所属分类
     * @param labelId    标签ID，用于筛选题目所属标签
     * @param cursor     游标方向，1表示下一个，-1表示上一个
     * @return 游标指向的题目ID
     */
    Long querySubjectIdCursor(Long subjectId, Long categoryId, Long labelId, int cursor);
}
